Side Panel UI Components

1. Introduction

2. Project Structure

3. Core Components

4. Architecture Overview

5. Detailed Component Analysis

6. Dependency Analysis

7. Performance Considerations

8. Troubleshooting Guide

9. Conclusion

This document provides comprehensive documentation for the Side Panel UI Components of the Agentic Browser extension. It focuses on the main App.tsx component structure, state management, and component composition patterns. It details the UnifiedSettingsMenu for configuration management, ProfileSidebar for user information display, ResponseSection for showing agent responses, and LoadingScreen for user feedback. The guide explains component hierarchy, prop passing, state synchronization, and styling approaches. It includes examples of component usage, customization options, and responsive design considerations. It also documents the integration with React hooks for authentication, tab management, and WebSocket communication, along with accessibility features, cross-browser styling compatibility, and performance optimization strategies.

The Side Panel UI resides under the extension entrypoint sidepanel and follows a feature-based organization:

• App.tsx orchestrates authentication, tab management, WebSocket integration, and renders the primary UI.

• Components are grouped under components/ with reusable UI primitives under components/ui/.

• Hooks encapsulate cross-cutting concerns: authentication, tab management, and WebSocket connectivity.

• Styling is centralized in App.css with global fonts loaded via index.html.

Diagram sources

• index.html

• main.tsx

• App.tsx

• UnifiedSettingsMenu.tsx

• ProfileSidebar.tsx

• ResponseSection.tsx

• LoadingScreen.tsx

• SignInScreen.tsx

• CuteTextInput.tsx

• ApiKeySection.tsx

• SettingsSection.tsx

• WebSocketStatus.tsx

• select.tsx

• useAuth.ts

• useTabManagement.ts

• useWebSocket.ts

• App.css

Section sources

• index.html

• main.tsx

• App.tsx

• App.css

This section outlines the primary UI components and their responsibilities:

• UnifiedSettingsMenu: Centralized configuration hub supporting profile, credentials, API keys, base URL, WebSocket preferences, and connection status.

• ProfileSidebar: Displays user profile details, token information, and actions for manual refresh/logout.

• ResponseSection: Renders agent responses in a scrollable container.

• LoadingScreen: Minimal loading interface while authentication resolves.

• SignInScreen: Onboarding screen with OAuth options and animated branding.

• CuteTextInput: Styled input with focus animations and Enter submission support.

• SettingsSection and WebSocketStatus: Compact settings and connection toggles.

• select.tsx: Reusable Radix UI-based Select primitive set.

Key integration points:

• App.tsx manages global state (authentication, tab info, API key, WebSocket connection, conversation stats) and passes props to child components.

• Hooks encapsulate browser APIs and external services (OAuth, tabs, WebSocket client).

• Styling leverages CSS modules and global styles for consistent theming.

Section sources

• App.tsx

• UnifiedSettingsMenu.tsx

• ProfileSidebar.tsx

• ResponseSection.tsx

• LoadingScreen.tsx

• SignInScreen.tsx

• CuteTextInput.tsx

• SettingsSection.tsx

• WebSocketStatus.tsx

• select.tsx

The Side Panel UI follows a unidirectional data flow:

• App.tsx initializes hooks and state, then conditionally renders either LoadingScreen, SignInScreen, or the main UI with AgentExecutor and settings/profile panels.

• Hooks manage browser-specific integrations (storage, tabs, identity, WebSocket).

• Components receive props and trigger updates via callbacks, ensuring predictable state transitions.

Diagram sources

• App.tsx

• useAuth.ts

• useTabManagement.ts

• useWebSocket.ts

App.tsx: Orchestrator and State Hub#

Responsibilities:

• Authentication lifecycle: initialize, refresh tokens, handle login/logout.

• Tab management: track active tab and update on changes.

• WebSocket integration: connect/disconnect, listen to events, update response state.

• Conversation statistics: fetch via WebSocket client or HTTP fallback.

• UI routing: render LoadingScreen, SignInScreen, or main app with settings/profile panels.

State and effects:

• Manages local state for API key, response, token visibility, conversation stats, and settings panel open state.

• Subscribes to browser storage changes for API key updates.

• Sends messages to background script to activate/deactivate AI frame.

Propagation pattern:

• Passes authentication and token helpers to UnifiedSettingsMenu and ProfileSidebar.

• Provides WebSocket connection status and response handler to UnifiedSettingsMenu.

Customization and responsiveness:

• Uses fixed positioning for settings panel with smooth transitions.

• Applies backdrop filters and glass-morphism styling via CSS.

Accessibility and cross-browser compatibility:

• Relies on browser APIs (storage, identity, tabs) and applies minimal DOM manipulation.

• Global CSS ensures consistent styling across browsers.

Section sources

• App.tsx

• App.css

UnifiedSettingsMenu: Configuration Management#

Responsibilities:

• Hosts two tabs: Settings and Profile.

• Settings tab: model selection, API key management, base URL, Google/JIIT connections, WebSocket auto-connect toggle.

• Profile tab: displays user info, token age/expiry, and advanced details.

State management:

• Maintains active tab, selected LLM, auto-connect preference, and JIIT portal credentials.

• Persists preferences to browser storage and localStorage.

Integration:

• Receives authentication props from App.tsx and exposes callbacks for logout/manual refresh.

• Uses CuteTextInput for secure input and handles Enter key submission.

Styling and UX:

• Fixed-position panel with smooth slide-in/out transitions.

• Glass-morphism design with backdrop blur and gradient backgrounds.

• Interactive elements include hover/focus states and subtle animations.

Section sources

• UnifiedSettingsMenu.tsx

• CuteTextInput.tsx

• ApiKeySection.tsx

• SettingsSection.tsx

• WebSocketStatus.tsx

• select.tsx

ProfileSidebar: User Information Display#

Responsibilities:

• Displays user avatar, name, email, and browser info.

• Shows token age/expiry and optional token visibility toggles.

• Provides manual refresh and logout actions.

Props and behavior:

• Controlled visibility via boolean prop; toggles via callback.

• Uses helper functions from App.tsx to compute token age/expiry.

Styling:

• Absolute positioning with shadow and gradient borders.

• Collapsible advanced details section using native details/summary.

Section sources

• ProfileSidebar.tsx

ResponseSection: Agent Response Display#

Responsibilities:

• Renders agent responses in a scrollable container with monospace-friendly styling.

Usage:

• Receives response string from App.tsx and conditionally renders when present.

Section sources

• ResponseSection.tsx

• App.css

LoadingScreen and SignInScreen: Authentication Flow#

• LoadingScreen: Minimal header and loading message while auth resolves.

• SignInScreen: Animated onboarding with OAuth options and feature highlights.

Both screens integrate with useAuth hooks to trigger login flows and update state.

Section sources

• LoadingScreen.tsx

• SignInScreen.tsx

• useAuth.ts

CuteTextInput: Reusable Input Component#

Features:

• Focus state with animated underline.

• Enter key submission support.

• Password/text modes with placeholder and controlled value.

Integration:

• Used within UnifiedSettingsMenu for API key/base URL inputs.

Section sources

• CuteTextInput.tsx

SettingsSection and WebSocketStatus: Compact Controls#

• SettingsSection: Collapsible settings with API key input and WebSocket connection toggle.

• WebSocketStatus: Simple indicator and reconnect button.

Section sources

• SettingsSection.tsx

• WebSocketStatus.tsx

select.tsx: UI Primitive#

• Provides a styled Select component set built on Radix UI with consistent theming and accessibility.

Section sources

• select.tsx

Component and hook dependencies:

• App.tsx depends on useAuth, useTabManagement, and useWebSocket.

• UnifiedSettingsMenu depends on browser storage/localStorage and the WebSocket client.

• ProfileSidebar consumes authentication props and helper functions.

• ResponseSection consumes response state from App.tsx.

• SignInScreen triggers authentication flows via useAuth.

Diagram sources

• App.tsx

• useAuth.ts

• useTabManagement.ts

• useWebSocket.ts

• UnifiedSettingsMenu.tsx

• ProfileSidebar.tsx

• ResponseSection.tsx

• CuteTextInput.tsx

• ApiKeySection.tsx

• SettingsSection.tsx

• WebSocketStatus.tsx

• select.tsx

• App.css

Section sources

• App.tsx

• UnifiedSettingsMenu.tsx

• ProfileSidebar.tsx

• ResponseSection.tsx

• CuteTextInput.tsx

• SettingsSection.tsx

• WebSocketStatus.tsx

• select.tsx

• useAuth.ts

• useTabManagement.ts

• useWebSocket.ts

• App.css

• Minimize re-renders by lifting state to App.tsx and passing only necessary props down.

• Debounce or throttle frequent updates (e.g., storage change listeners).

• Use lazy initialization for heavy resources (e.g., WebSocket client setup).

• Keep component trees shallow; avoid deep nesting of styled containers.

• Prefer CSS transitions for animations rather than JavaScript-driven ones.

• Utilize browser storage efficiently; batch writes and avoid excessive reads.

Common issues and resolutions:

• Authentication failures: Verify backend service availability and OAuth configuration. Check alerts emitted during login flows.

• WebSocket disconnections: Confirm auto-connect preference and network connectivity; use the reconnect button in settings.

• Tab updates not reflected: Ensure tab listeners are registered and cleaned up properly.

• Styling inconsistencies: Confirm global fonts are loaded and CSS selectors match component classes.

Section sources

• useAuth.ts

• useWebSocket.ts

• useTabManagement.ts

• App.css

The Side Panel UI Components form a cohesive, modular system centered around App.tsx. They leverage React hooks for cross-cutting concerns, maintain consistent styling through global CSS, and provide intuitive controls for configuration and user profile management. The architecture supports scalability, accessibility, and cross-browser compatibility while keeping performance considerations front-of-mind.